package com.snapan.dao;

import com.snapan.entity.EmailVerification;
import org.apache.ibatis.annotations.Param;
import org.springframework.stereotype.Repository;

import java.util.Date;
import java.util.List;

/**
 * 邮箱验证码表数据访问接口
 */
@Repository
public interface EmailVerificationDao {

    /**
     * 根据ID查询验证码记录
     */
    EmailVerification selectById(Long id);

    /**
     * 查询所有
     */
    List<EmailVerification> selectAll();

    /**
     * 更新
     */
    int update(EmailVerification emailVerification);

    /**
     * 根据ID删除
     */
    int deleteById(Long id);




    /**
     * 检查邮箱在指定时间内是否已发送过验证码（防滥用）
     */
    int countRecentRequests(@Param("email") String email);


    /**
     * 标记验证码为已使用
     */
    int updateToUsed(@Param("id") Long id);



    /**
     * 根据邮箱和类型查询所有验证码记录
     */
    List<EmailVerification> selectByEmailAndType(
            @Param("email") String email,
            @Param("type") Byte type
    );

    /**
     * 插入验证码记录
     */
    int insert(EmailVerification record);

    /**
     * 查找有效的验证码记录
     */
    EmailVerification findValidCode(@Param("email") String email,
                                    @Param("code") String code,
                                    @Param("type") Byte type,
                                    @Param("now") Date now);

    /**
     * 统计近期请求次数
     */
    Integer countRecentRequests(@Param("email") String email,
                                @Param("type") Byte type,
                                @Param("afterTime") Date afterTime);

    /**
     * 标记为已使用
     */
    int markAsUsed(@Param("id") Long id);

    /**
     * 删除过期验证码
     */
    int deleteExpired();


}